Skip to content

feat (suggestion): add shared skills settings#1085

Open
JustYannicc wants to merge 2 commits intopingdotgg:mainfrom
JustYannicc:codex/issue-1081-shared-skills
Open

feat (suggestion): add shared skills settings#1085
JustYannicc wants to merge 2 commits intopingdotgg:mainfrom
JustYannicc:codex/issue-1081-shared-skills

Conversation

@JustYannicc
Copy link

@JustYannicc JustYannicc commented Mar 14, 2026

What Changed

Implements shared skill management #1081.

This adds a Skills section in Settings, similar to Codex, where shared skills can be initialized and managed. On first use, skills are moved into a user-defined shared directory and symlinked back into the harness skill roots so Codex can keep working as usual without needing to know anything about the shared setup.

The PR also adds:

  • first-run initialization flow
  • shared skill discovery across the current Codex roots
  • enable / disable / uninstall actions
  • recheck + explicit move flow for newly discovered skills after initialization
  • backend + websocket plumbing and tests for the shared-skills flow

Why

The goal is to make local skills more portable across harnesses while keeping Codex behavior unchanged.

I mainly built this for myself so I can keep skills in one shared location and eventually reuse the same setup across tools like Codex and Claude Code. From Codex’s perspective, it should still just see normal skill directories in the places it already expects, because the shared setup is handled through symlinks.

This is tied to #1081, but there is no expectation that this has to be merged. I’m opening it in case the implementation is useful, and I’m completely fine if you decide not to take it.

If there are any changes I have to make, let me know.

UI Changes

Settings Screen

Before:
Screenshot 2026-03-14 at 17 23 23

After:

Screenshot 2026-03-14 at 18 39 40

New Skills Setting Screen

Screenshot 2026-03-14 at 18 46 02 Screenshot 2026-03-14 at 18 41 43

Single Skill clicked in

Screenshot 2026-03-14 at 18 43 31

Checklist

  • This PR is small and focused
  • I explained what changed and why
  • I included before/after screenshots for any UI changes
  • I included a video for animation/interaction changes

Note

Add shared skills settings panel with lifecycle management via WebSocket API

  • Adds a new SkillsSettingsPanel component under a new "Skills" tab in the settings page, reachable via ?tab=skills in the URL.
  • Introduces sharedSkills.ts on the server with functions to discover, migrate, enable/disable, and uninstall skills across Codex and Agents harness directories using a shared directory with symlinks.
  • Exposes five new WebSocket RPC methods (getSharedSkills, getSharedSkillDetail, initializeSharedSkills, setSharedSkillEnabled, uninstallSharedSkill) backed by corresponding React Query hooks in sharedSkillsReactQuery.ts.
  • Adds sharedSkillsPath to AppSettingsSchema with an empty-string default, allowing users to configure the shared skills directory via folder picker in the UI.
  • Adds Effect/Schema types and IPC contracts in packages/contracts for all shared skill operations.
📊 Macroscope summarized a78c30d. 12 files reviewed, 3 issues evaluated, 0 issues filtered, 3 comments posted

🗂️ Filtered Issues

@coderabbitai
Copy link

coderabbitai bot commented Mar 14, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: be7f19de-f79c-4c8c-aa38-6b8eec1f9ad7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Tip

You can make CodeRabbit's review stricter and more nitpicky using the `assertive` profile, if that's what you prefer.

Change the reviews.profile setting to assertive to make CodeRabbit's nitpick more issues in your PRs.

@github-actions github-actions bot added size:XXL 1,000+ changed lines (additions + deletions). vouch:unvouched PR author is not yet trusted in the VOUCHED list. labels Mar 14, 2026
@JustYannicc JustYannicc force-pushed the codex/issue-1081-shared-skills branch from a78c30d to 1120ea8 Compare March 15, 2026 18:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL 1,000+ changed lines (additions + deletions). vouch:unvouched PR author is not yet trusted in the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant